home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / standard / endpolygon.z / endpolygon
Text File  |  1998-10-20  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. eeeennnnddddppppoooollllyyyyggggoooonnnn((((3333GGGG))))                                                  eeeennnnddddppppoooollllyyyyggggoooonnnn((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      bbbbggggnnnnppppoooollllyyyyggggoooonnnn,,,, eeeennnnddddppppoooollllyyyyggggoooonnnn - delimit the vertices of a polygon
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd bbbbggggnnnnppppoooollllyyyyggggoooonnnn(((())))
  13.  
  14.      vvvvooooiiiidddd eeeennnnddddppppoooollllyyyyggggoooonnnn(((())))
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _n_o_n_e
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      Vertices specified after bbbbggggnnnnppppoooollllyyyyggggoooonnnn and before eeeennnnddddppppoooollllyyyyggggoooonnnn form a single
  21.      polygon.  The polygon can have a maximum of 256 vertices.  Use the vvvv
  22.      subroutine to specify a vertex. Self-intersecting polygons (other than
  23.      four-point bowties) may render incorrectly.  If a quadrilateral projects
  24.      a self-intersecting polygon, its rendering will be hardware-specific. The
  25.      Graphics Library only guarantees that pixels outside of the convex hull
  26.      will not be modified.  Also, concave polygons may not render correctly if
  27.      you have not called ccccoooonnnnccccaaaavvvveeee((((TTTTRRRRUUUUEEEE)))).
  28.  
  29.      Between bbbbggggnnnnppppoooollllyyyyggggoooonnnn and eeeennnnddddppppoooollllyyyyggggoooonnnn, you can issue only the following
  30.      Graphics Library subroutines:  cccc, ccccoooolllloooorrrr, ccccppppaaaacccckkkk, llllmmmmbbbbiiiinnnndddd, llllmmmmccccoooolllloooorrrr, llllmmmmddddeeeeffff,
  31.      nnnn, RRRRGGGGBBBBccccoooolllloooorrrr, tttt, and vvvv.  Use llllmmmmddddeeeeffff and llllmmmmbbbbiiiinnnndddd to respecify only materials
  32.      and their properties.
  33.  
  34.      By default polygon vertices are forced to the nearest pixel center prior
  35.      to scan conversion.  Polygon accuracy is improved when this coercion is
  36.      defeated with the ssssuuuubbbbppppiiiixxxxeeeellll command.  Subpixel vertex positioning is
  37.      especially important when polygons are scan converted with antialiasing
  38.      enabled (see ppppoooollllyyyyssssmmmmooooooootttthhhh).
  39.  
  40.      After eeeennnnddddppppoooollllyyyyggggoooonnnn, the current graphics position is undefined.
  41.  
  42. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  43.      backface, c, concave, frontface, polymode, polysmooth, scrsubdivide,
  44.      defpattern, shademodel, subpixel, v
  45.  
  46. NNNNOOOOTTTTEEEESSSS
  47.      If you want to use the bbbbaaaacccckkkkffffaaaacccceeee or ffffrrrroooonnnnttttffffaaaacccceeee routines, specify the
  48.      vertices in counter-clockwise order.
  49.  
  50.      Although calling ccccoooonnnnccccaaaavvvveeee((((TTTTRRRRUUUUEEEE)))) will guarantee that all polygons will be
  51.      drawn correctly, on the IRIS-4D B and G models, the Personal Iris, Iris
  52.      Entry, Indy, XL, XS, XS24, XZ, Elan, and Extreme systems, doing so causes
  53.      performance to be degraded.
  54.  
  55.      See the section, "2.1.4 Polygons," in the Graphics Library Programming
  56.      Guide for a discussion on the handling of non-coplanar and/or self-
  57.      intersecting polygons.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. eeeennnnddddppppoooollllyyyyggggoooonnnn((((3333GGGG))))                                                  eeeennnnddddppppoooollllyyyyggggoooonnnn((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      On Impact and Infinite Reality llllmmmmccccoooolllloooorrrr cannot be called between
  75.      bbbbggggnnnnppppoooollllyyyyggggoooonnnn and eeeennnnddddppppoooollllyyyyggggoooonnnn
  76.  
  77.      On Impact and Infinite Reality ccccoooonnnnccccaaaavvvveeee((((TTTTRRRRUUUUEEEE)))) severly hurts performance
  78.      and some non-simple four sided polygons cannot be handled correctly.
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.